home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / bbs_game / sdl212x.zip / SDCREATE.TXT < prev    next >
Text File  |  1996-05-15  |  13KB  |  451 lines

  1. STARDOCK LOCO SCRIPT FILE CREATOR VERSION .01
  2. --------------------------------------------------------------------------
  3. What you need:  sdcreat1.exe
  4.         A good imagination
  5.         Knowledge of a the simple commands
  6.         Paper and Pencil
  7.  
  8. Why the paper and pencil?  Well, you should outline what it is you're going
  9. to do before you start writing your program.  It'll make the game easier to
  10. create in the long run.
  11.  
  12. Note:  I do all the memory allocation, player updates, and all the serial
  13.        port bbs nonsense.  You do the writing!  It's easy!
  14.  
  15. --------------------------------------------------------------------------
  16. EDITOR FORMAT:   Most of your game will just be filling in text!
  17. --------------------------------------------------------------------------
  18.  
  19.  
  20.     Command: ________    <-defaults to TEXT command
  21.  
  22.               (Data/Text area)
  23.     _______________________________________________________
  24.  
  25.     Line number: _____   <-defaults to current line number
  26.  
  27.  
  28.  
  29. --------------------------------------------------------------------------
  30. COMMANDS:  (Easy to use!!! See the quick reference that follows)
  31. --------------------------------------------------------------------------
  32. New Commands:  PAUSE, HEAL
  33.  
  34. Fixed Commands:  Bunch of 'em...<G>
  35.  
  36.  
  37. Input and output:
  38.     SIZE, TEXT, GETKEY, YES/NO, IF KEYx, GOTO, WAIT, ANSI, END
  39.     REM, CLRSCR, VIEW
  40.  
  41. Player goodies:
  42.     ADD LP, ADD CR, ADD DR, ADD AR, SUB LP, SUB CR, SUB AR
  43.  
  44. Built in battles with aliens:
  45.     FITE1, FITE2, FITE3, FITE4, FITE5, FITE?
  46.  
  47. 4 Switches you can set for on and off and check them.
  48.     A, B, C, D
  49.  
  50. And more....But you don't need 'em all.
  51.  
  52.  
  53. NOTE:   Anything with an  "<---" is a note in the sample programs.  But don't
  54.     try to use them in the editor!
  55.  
  56.  
  57. --------------------------------------------------------------------------
  58.  
  59. The following are the simple commands used in the sdcreat1.exe editor.
  60.  
  61. SIZE     ****Must**** be the first line of the program.  (Line 0)
  62.          This tells Stardock Loco how many lines you have for
  63.          memory allocation.  (I do all that for you.)
  64.  
  65.          In the editor:
  66.  
  67.          Command:   SIZE
  68.  
  69.             (Text/data area)
  70.  
  71.          196___________________________________________________
  72.  
  73.         All you need to do is put the number of lines in your
  74.         program in the text/data area.
  75.  
  76.  
  77. TEXT         A line of text.  Fill the data area with what you want
  78.          the user to see.
  79.  
  80.          To put colors into the data line, use the following:
  81.  
  82.             `red`
  83.             `blue`
  84.             `white`         All of these can be brightened by
  85.             `green`         doing the following `bright white`
  86.             `yellow`
  87.             `cyan`
  88.  
  89.                      (Data/Text area)
  90.          Example:   `cyan`My name is `bright red`Bob. `cyan` Hello!
  91.  
  92.             This will make Bob red, and the rest of the line
  93.             cyan, as well as the following lines cyan until you
  94.             change the color again.
  95.  
  96. NOTE:  HEAL and PAUSE will not show up in your editor as valid commands,
  97.        but they work on line.  I have lost the code for the sdcreat1.exe,
  98.        and am working on a new version.
  99.  
  100. HEAL        Heals the player completely.
  101.  
  102. PAUSE
  103.  
  104.          In the editor:
  105.  
  106.          Command:   PAUSE
  107.  
  108.             (Text/data area)
  109.  
  110.          50___________________________________________________
  111.  
  112.          This will cause the screen to pause for an amount of time.
  113.          This runs in clock cycles of the computer that runs it.  You
  114.          will have to figure out what a good amount of time is.
  115.  
  116. GOTO
  117.  
  118.     This causes the game to go to the line specified.  (Bad for real
  119.     programming, good for this simple script creator.)
  120.  
  121.     ***NOTE:  It goes to the line specified, but skips that line!!
  122.     to go to line 1, you would specify line 0.
  123.  
  124.     Usage:
  125.  
  126.     Command:  GOTO
  127.                 (Text/data area)
  128.         9_____________________________________________________
  129.                            ^these are just blanks
  130.  
  131.     This will cause the program you created to go to just after line # 9
  132.     and start processing at line 10.
  133.  
  134.  
  135.  
  136.  
  137. YES/NO
  138.  
  139.     Prompts the user for an answer:     Enter [Y/N]:
  140.     This prompt is created by me.  If it is a Y (upper or lower), it
  141.     will do the next line of your program.  If it is a N, it will skip
  142.     that line and continue.
  143.  
  144.     Example program:
  145.  
  146.     (Line #) (Command)   (Data/text area)
  147.  
  148.        0      SIZE       11
  149.        1      TEXT       I am the king!!!  Agree?
  150.        2      YES/NO     <---if it's yes, it will go to 10
  151.        3      GOTO       9   <--starts doing what's at line 10
  152.        4      TEXT       Awww, what do you know anyway? <G>
  153.        5      END
  154.        .
  155.        .
  156.       10      TEXT       Good answer!! You get `red`30`cyan` lifepoints!
  157.       11      END
  158.  
  159.     This display the "I am the king!!!  Agree?" to the user.
  160.     Then it prompts  "Enter [Y/N]: "
  161.     if they answer Y they get 30 lifepoints.  If not, the program ends.
  162.  
  163. END
  164.  
  165.     Stops your script from running.  No matter where you are in it.
  166.     I will display the following before it quits:
  167.  
  168.             Returning to Stardock Loco.
  169.             Enter to continue...
  170.  
  171.             They hit enter, they go Loco.
  172.  
  173. GETKEY
  174.  
  175.     Gets a key from the user.  You have exactly 5 choices for this.
  176.     1,2,3,4,5.  You have to tell them which ones to use.
  177.  
  178.  
  179.     Example program:
  180.  
  181.     (Line #) (Command)   (Data/text area)
  182.  
  183.        0      SIZE       60
  184.        1      TEXT       -=* The Plains of G'ar *=-
  185.        2      TEXT              <1>  North
  186.        3      TEXT            <2>  South
  187.        4      TEXT       Enter your choice:
  188.        5      GETKEY             <---will accept 1-5, so be careful!
  189.        6      IF KEY1
  190.        7      GOTO       29  <--starts at line 30!
  191.        8      IF KEY2
  192.        9      GOTO       49
  193.        .
  194.        .
  195.        30     TEXT       You are at the north entrance of the G'ar stronghold...
  196.        31     TEXT       Do you want to enter?
  197.        32     YES/NO
  198.        .
  199.        .
  200.        .
  201.        50     TEXT       You have come across a G'ar Chieftan!!!
  202.        51     FITE1      <----more on this little baby later.
  203.  
  204.  
  205.         Get the idea?  It's very easy.  For those of you that are
  206.         programmers, you may cringe...<G>
  207.  
  208.  
  209. WAIT
  210.  
  211.     This simply stops the display until the user hits the enter key.
  212.     It prompts them with the   "Enter to Continue: "
  213.  
  214.  
  215. CLRSCR
  216.  
  217.     Clears the screen.
  218.  
  219. --------------------------------------------------------------------------
  220. Adding and subtracting items from a player
  221. --------------------------------------------------------------------------
  222.  
  223. With all of these commands, you just put the command into the editors command
  224. box, and the amount into the text/data area.
  225.  
  226.     Example:
  227.  
  228.         Command:   ADD CR
  229.  
  230.             (text/data area)
  231.         1000______________________________________
  232.          ^this would add 1000 credits to the player.
  233.  
  234. They are as follows:
  235.     ADD CR       Add      credits
  236.     ADD LP                lifepoints
  237.     ADD DR                droids
  238.     ADD AR                armor
  239.     ADD EN                energy packs
  240.     ADD PC                passcards
  241.  
  242. ***This will show on the players monitor:
  243.             You receive 10 lifepoints!
  244.  
  245.  
  246.     SUB CR       Subtract credits
  247.     SUB LP                lifepoints
  248.     SUB DR                droids
  249.     SUB AR                armor
  250.     SUB EN                energy packs
  251.     SUB PC                passcards
  252.  
  253. ***This will show on the players monitor:
  254.             You lose 20 droids!
  255.  
  256.             (if it is greater than what they
  257.             have, it will show the amount they have or 0)
  258.  
  259.     I do all the checking and writing of the player files.
  260.  
  261. IF CR:       (credits)
  262. IF EN:       (energy packs)
  263. IF DR:       (droids)
  264. IF PC:       (passcards)
  265.  
  266.           This example would check to see if the player had 1000
  267.           credits.  If they do, it will do the next line.  If they
  268.           don't, it will tell them that they do not have enough
  269.           credit/droids/energy packs.  Then it would skip the next line.
  270.           This is good if you are selling something to them.
  271.  
  272.          Command:  IF CR
  273.                 (data/text area)
  274.          1000_______________________________________
  275.  
  276.                  10   TEXT   Buy the droid for $1,000,000?
  277.                  11   YES/NO
  278.                  12   GOTO   13
  279.                  13   END
  280. That GOTO 13 goes to here!-->
  281.                  14   IF CR  1000000    <--if they don't have it
  282.                  15   GOTO   16
  283.                  16   END <--it will tell them not enough $, then end.
  284. That GOTO 16 goes to here!-->
  285.                  17   TEXT   You've bought yourself a droid!
  286.                  18   ADD DR 1
  287.                  19   SUB CR 1000000
  288.  
  289.  
  290. -------------------------------------------------------------------------
  291. Using the switches:
  292. -------------------------------------------------------------------------
  293. These are for specialized programs.  You may find them handy. I would die
  294. without a good switch/flag.
  295.  
  296. They start as OFF.  (FALSE or 0 to you programmers, wanna talk boolean? <G>)
  297.  
  298. You have 4 switches:
  299.         A
  300.         B
  301.         C
  302.         D
  303.  
  304. To turn it on:  A ON
  305.         B ON   etc....
  306.  
  307. To turn it off: A OFF
  308.         C OFF  etc....
  309.  
  310. To turn all off:  ALL OFF
  311.  
  312. To use one:
  313.         IF A ON                 <---will go to next line if ON
  314.         GOTO       20           <---if it is OFF it will skip.
  315.  
  316.          Once again, similar to the YES/NO it will do the next line
  317.          if the A is set to ON.
  318.          Otherwise it will skip the next line.
  319.  
  320. NOTE: (IF A ON, IF B ON, etc)
  321.  
  322.  
  323. RAND         This creates a random number for the flags.  It will turn off
  324.          all the flags automatically, then do the random number for
  325.          a flag
  326.  
  327.         Command:  RAND
  328.                 (data/text area)
  329.          ___________________________________________
  330.  
  331.         It would randomly turn ON one of the A,B,C,D flags.
  332.  
  333.  
  334.          This could be used to create a random mission on a wasteland...
  335.          Each player would have a somewhat different mission.
  336.          Example:
  337.  
  338.  
  339.         5     TEXT      Do you wish to continue?
  340.         6       YES/NO
  341.         7       GOTO      19          <---yes goes to 20
  342.         8       END
  343.         .
  344.         .
  345.         20    RAND      <--turns 'em off then randomly turns 1 on
  346.         21      IF A ON
  347.         22      GOTO      49
  348.         23      IF B ON
  349.         24      GOTO      99
  350.         .
  351.         .
  352.         100     TEXT      Do this Do that....
  353.         101     TEXT      Something else....
  354.         102     GOTO      4           <---go back to the beginning.
  355.  
  356.  
  357. ANSI        Displays and ANSI, AVATAR, ASCII, or RIP file.  Must be in
  358.         the current directory.  Valid types( .asc, .ans, .avi, .rip)
  359.  
  360.  
  361.         Example:
  362.  
  363.               Command: ANSI
  364.  
  365.                  (data/text area)
  366.            monster.ans__________________________________
  367.  
  368.  
  369.         I didn't use any Ansi pictures in SD since I hated seeing the
  370.         suckers slowly float across the screen on my 28.8 modem when
  371.         I played other games.  Use your discretion, use a million.
  372.         Heck I don't care!  It's your script!  Hopefully they will
  373.         be pretty....  But you could use The Draw to create your
  374.         cool menus and such.  That would work.
  375.  
  376.  
  377.  
  378.     Example:
  379.         1   SIZE   10
  380.         2   ANSI   mymenu.ans  <--has your menu choices
  381.         3   GETKEY
  382.         4   IF KEY1
  383.         5   GOTO   50
  384.         6   IF.....blah blah blah..!
  385.  
  386.  
  387. -------------------------------------------------------------------------
  388. Using the built in Battles
  389. -------------------------------------------------------------------------
  390. FITE1           a level 1 bad guy
  391. FITE3                   3           <---note, no level 2
  392. FITE4                   4
  393. FITE5                   5
  394. FITE6                   6
  395. FITE?           a random bad guy from the above list
  396.  
  397. IF !RAN         This is on if they didn't run from the fight.  See example.
  398.  
  399. If you use one of these, I will fight them to the death of either the player
  400. or the alien.  If they die, they leave your script, and leave Stardock.  If
  401. the player lives or runs, they continue on in your script.
  402.  
  403.  
  404.     Example:
  405.  
  406.         20   FITE?       <---a random bad guy battle
  407.         30   IF !RAN     <---always reset before a battle.
  408.         40   GOTO        69         <---if they won.
  409.         50   TEXT        Blah blah blah
  410.         .
  411.         .
  412.         .
  413.         60   ANSI        victory.ans
  414.         70   TEXT        `red`You won!! `white`
  415.         80   ADD CR      1000
  416.         90   ADD AR      50
  417.            100   GOTO        12
  418.  
  419.  
  420. REM      Well, thank dos, you can leave a comment in your file!  Will skip over
  421.      whatever is in that data/text line.  Just don't put it in line 0.
  422.      or your program is history!
  423.  
  424.  
  425. STATS
  426.     Shows the player his statistics.  Just like in Loco, without the
  427.     ship statistics.  It will clear the screen, display the stats,
  428.     then wait for an enter key before continuing.
  429.  
  430.     Example:
  431.             9    ANSI      mymenu.ans
  432.             10   GETKEY
  433.             11   IF KEY1
  434.             12   GOTO      99
  435.             13   IF KEY2
  436.             14   GOTO      149
  437.             .
  438.             .
  439.             100  STATS     <---clears screen, shows stats, waits
  440.             101  GOTO      8      <--then goes back to menu
  441.  
  442. That's it!  Since this thing is run from an expansion module in Stardock Loco,
  443. expect an enhanced version with more commands in the future.  (And your old
  444. ones will still run)  For those of you that wish to write in pure C or another
  445. language other than my LocoScript,
  446. check out the file SD_DVLP.TXT.  Then you can create complete
  447. add-ons like my expansion modules, and also create registration versions that
  448. you can sell.  I suppose you could use this and try to have people register
  449. them, but I know how that goes...Forvala.
  450.  
  451.